---
title: "List base members"
method: GET
path: "/api/v3/meta/bases/{baseId}?include[]=members"
tags: ["Base Members"]
---

# List base members

`GET /api/v3/meta/bases/{baseId}?include[]=members`

## Request

- Base URL: `https://app.nocodb.com`
- URL: `https://app.nocodb.com/api/v3/meta/bases/{baseId}?include[]=members`
- Auth: one of:
  - API key in header `xc-token`
  - HTTP bearer
- TypeScript: <https://skmtc.dev/nocodb/apis/nocodb-v3/docs/api/v3/meta/bases/:baseId%3Finclude[]=members/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieve all details of a specific base, including its members.

Notes: Base collaboration APIs are available on cloud-hosted **Business** plans and above, and on licensed self-hosted deployments (**Business** plan and above).

## Path parameters

- `baseId` string, required

## Response `200`

Base meta with members & their access information was retrieved.

- BaseWithMembers
  - `id` string, required: Unique identifier for the base.
  - `title` string, required: Title of the base.
  - `meta` BaseMetaRes, required
    - `icon_color` string: Specifies the color of the base icon using a hexadecimal color code (e.g., `#36BFFF`)
  - `created_at` string, date-time, required: Timestamp of when the base was created.
  - `updated_at` string, date-time, required: Timestamp of when the base was last updated.
  - `workspace_id` string, required: Unique identifier for the workspace to which this base belongs to.
  - `sources` object[]: List of data sources associated with this base. This information will be included only if one or more external data sources are associated with the base.
    - `id` string, required: Unique identifier for the data source.
    - `title` string, required: Title of the data source.
    - `type` string, required: Type of the data source (e.g., pg, mysql).
    - `is_schema_readonly` boolean, required: Indicates if the schema in this data source is read-only.
    - `is_data_readonly` boolean, required: Indicates if the data (records) in this data source is read-only.
    - `integration_id` string, required: Integration ID for the data source.
  - `individual_members` object
    - `base_members` BaseMemberWithWorkspaceRole[]
      - `user_id` string, required: Unique identifier for the user.
      - `email` string, email, required: Email address of the user.
      - `display_name` string: Display name of the user.
      - `created_at` string, date-time, required: Timestamp of when the user was added to the base.
      - `updated_at` string, date-time, required: Timestamp of when the membership was last updated.
      - `base_role` 'owner' | 'creator' | 'editor' | 'viewer' | 'commenter' | 'no-access' | 'inherit' | 'app-user', required: Base role as reported on a member read. A superset of `BaseRoles`: `inherit` means the role comes from the workspace rather than the base, and `app-user` is an external app-only collaborator with no ambient base access. Neither can be assigned — they are never valid in a request body.
      - `workspace_role` 'workspace-level-owner' | 'workspace-level-creator' | 'workspace-level-editor' | 'workspace-level-viewer' | 'workspace-level-commenter' | 'workspace-level-no-access' | 'workspace-level-inherit': Workspace role as reported on a member read. A superset of `WorkspaceRoles`: `workspace-level-inherit` means the role is inherited from the organization rather than set on the workspace. It cannot be assigned — it is never valid in a request body.
    - `workspace_members` WorkspaceMember[]
      - `email` string, email, required: Email address of the member
      - `user_id` string, required: Unique identifier for the user
      - `created_at` string, date-time, required: Timestamp when the user was added to the workspace
      - `updated_at` string, date-time, required: Timestamp when the user was last updated in the workspace
      - `workspace_role` 'workspace-level-owner' | 'workspace-level-creator' | 'workspace-level-editor' | 'workspace-level-viewer' | 'workspace-level-commenter' | 'workspace-level-no-access' | 'workspace-level-inherit', required: Workspace role as reported on a member read. A superset of `WorkspaceRoles`: `workspace-level-inherit` means the role is inherited from the organization rather than set on the workspace. It cannot be assigned — it is never valid in a request body.

## Other responses

- `404`: Base not found.
- `500`: Server error.

## Changes

- **2026-10-13** `2ba4267a99d7`: 5 warning, 3 info
  - removed the optional property `individual_members/base_members/items/user_name` from the response with the `200` status
  - added the new `app-user` enum value to the `individual_members/base_members/items/base_role` response property for the response status `200`
  - added the new `inherit` enum value to the `individual_members/base_members/items/base_role` response property for the response status `200`
  - added the new `workspace-level-inherit` enum value to the `individual_members/base_members/items/workspace_role` response property for the response status `200`
  - …4 more

[Operation history](https://skmtc.dev/nocodb/apis/nocodb-v3/changes/api/v3/meta/bases/:baseId%3Finclude[]=members/get.md)

---

[API](https://skmtc.dev/nocodb/apis/nocodb-v3.md) - [All operations](https://skmtc.dev/nocodb/apis/nocodb-v3/llms.txt) - [OpenAPI document](https://skmtc.dev/nocodb/apis/nocodb-v3/revisions/62a735aaf849?raw)